home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / tools / cpx_acc / teleinx / teleinx.txt < prev    next >
Encoding:
Text File  |  1994-09-22  |  16.2 KB  |  447 lines
  1.  
  2.       ##### #####  #     ##### ##### #   # #   #     ####  ####  #   #
  3.         #   #      #     #       #   ##  #  # #     #      #   #  # #
  4.         #   ###    #     ###     #   # # #   #      #      ####    #
  5.         #   #      #     #       #   #  ##  # #     #      #      # #
  6.         #   #####  ##### ##### ##### #   # #   #  #  ####  #     #   #
  7.  
  8.  
  9.  
  10.                   Telefonnummern- und Adressenverzeichnis
  11.  
  12.  
  13.                              Copyrights by
  14.  
  15.                           Andreas Mandel @ OG
  16.  
  17.                              Version 2.05
  18.  
  19.                               20.04.1993
  20.  
  21.  
  22.                        >>>>  F R E E W A R E  <<<<
  23.  
  24.  
  25.                          Programmiert mit PURE C
  26.                          
  27.                       
  28.           (Dokumentation und ChefBetaTester:  Alexander Güth @ WÜ)
  29.  
  30.  
  31.  
  32.   EINLEITUNG / FUNKTIONSPRINZIP
  33.   ----------------------------------------------------------------------------
  34.  
  35.   TELEINX.CPX, ist ein CPX-Modul, welches mit dem modularen Kontrollfeld von
  36.   ATARI (XCONTROL), benutzt werden kann. Mit TELEINX.CPX kann man Telefon-
  37.   nummern und Adressen auf einfache Art zum Abruf bereit stellen.
  38.  
  39.   Die Telefonnummern können dazu in einer einfachen ASCII Datei gespeichert
  40.   oder z.B. aus einer bestehenden Datenbank exportiert werden.
  41.   
  42.   Und das beste, TELEINX erlaubt es Telefonnummer über das Modem zu wählen,
  43.   also kein auswendiglernen mehr oder Notizbuch suchen !!!
  44.  
  45.  
  46.   LAUFFÄHIGKEIT
  47.   ----------------------------------------------------------------------------
  48.  
  49.   TELEINX.CPX sollte dank des modularen Kontrollfeldes von ATARI auf allen
  50.   Rechnern/TOS-Version (>=1.04) und in allen Auflösungen (ST-LOW bis TT-HIGH)
  51.   sowie Grafikkarten laufen.
  52.  
  53.   TELEINX.CPX benötigt im aktiven Betriebszustand, d.h. wenn es vom Kontroll-
  54.   feld aufgerufen wird oder auch resident geladen wird, ca. 12 KB Speicher und
  55.   je nach Einstellung der max. Einträge ca. 1-20 KB zusätzlichen Daten-
  56.   speicher.
  57.  
  58.   Im passiven Betriebszustand, d.h. nicht resident im Kontrollfeld und nicht
  59.   gestartete CPX-Application, benötigt TELEINX.CPX nur 512 Bytes (!!!), d.h.
  60.   nur der CPX-Header ist geladen :-).
  61.  
  62.  
  63.   LIEFERUMFANG
  64.   ----------------------------------------------------------------------------
  65.  
  66.   Das Softwarepaket besteht aus folgenden Dateien:
  67.  
  68.   TELEINX .CPX :  CPX-Modul
  69.   TELEINX .TXT :  Diese Anleitung
  70.   TELEBSP .TXT :  Eine Beispielnummern Datei
  71.   TELEINX .UPL :  Uploadtext für Mailboxen
  72.  
  73.   Eine Weitergabe des unvollständigen Softwarepaketes ist untersagt !!!
  74.  
  75.  
  76.   COPYRIGHT
  77.   ----------------------------------------------------------------------------
  78.  
  79.   TELEINX.CPX ist FREEWARE, d.h.
  80.  
  81.   o Sie dürfen TELEINX.CPX beliebig weitergeben, jedoch muß stets der Inhalt
  82.     des Ordners TELEINX KOMPLETT und UNVERÄNDERT kopiert werden. 
  83.     Kürzungen und Änderungen verletzen die Copyright-Bestimmungen!
  84.  
  85.   Eine Verbreitung über Mailboxen ist gestattet. Der Vertrieb in Verbindung
  86.   mit kommerzieller Software oder über PD/Shareware-Anbieter ist nur nach
  87.   vorheriger Absprache erlaubt. (Verstöße werden geahndet !!!)
  88.  
  89.   Fehlerberichte, Fragen und Unterstüzungen sind mir immer willkommen.
  90.  
  91.    Postanschrift:   Andreas Mandel
  92.                     Postfach 26
  93.                     7601 Ortenberg
  94.                     D-W 7601 Ortenberg  (ab 1.7.93,  77799 Ortenberg)
  95.  
  96.          E-Mail :   Andreas_Mandel@og.maus.de
  97.          MausNet:   Andreas Mandel @ OG
  98.  
  99.   Bankverbindung:   Volksbank Offenburg
  100.                     Kto.Nr. 6478 4307
  101.                     BLZ     664 900 00
  102.   
  103.  
  104.   UPDATE / UPGRADE
  105.   ----------------------------------------------------------------------------
  106.   
  107.   Die neueste Version von TELEINX, gibt es immer
  108.   
  109.   a) in der Maus OG (0781-38807) im öffentlichem Programmteil unter dem Namen
  110.      "TELE*.*"
  111.      
  112.   b) gegen Einsendung einer Diskette zusammen mit einem ausreichend
  113.      frankierten und an Sie adressierten Rückumschlag
  114.           
  115.  
  116.   HAFTUNGSAUSSCHLUß
  117.   ----------------------------------------------------------------------------
  118.  
  119.   Natürlich kann die Funktionsfähigkeit des CPX-Moduls nicht garantiert
  120.   werden und der Autor haftet auch nicht für irgendwelche Schäden, die sich
  121.   aus der Benutzung des Programmes oder der Dokumentation ergeben können.
  122.  
  123.  
  124.   INSTALLATION
  125.   ----------------------------------------------------------------------------
  126.  
  127.   - Kopieren Sie TELEINX.CPX in den CPX-Ordner von XCONTROL (ATARI)
  128.   - Aktivieren Sie das XCONTROL.ACC, d.h. Endung = .ACC
  129.   - Booten Sie den Rechner neu oder laden Sie im XCONTROLL.ACC unter dem
  130.     Menüpunkt "Voreinstellungen" die CPX-Module neu ein.
  131.   - Rufen Sie TELEINX.CPX auf     (Doppelklick auf "Telefonbuch" )
  132.   - Klicken Sie auf das PupUp-Menü "Optionen" und wählen Sie den Menüpunkt
  133.     "Datenbank Setup..." aus.
  134.   - Klicken Sie auf die Pfadzeile. Es öffnet sich nun eine Fileselectorbox,
  135.     in welcher Sie den Pfad zu der Telefonnummerndatei (z.B. TELEBSP.TXT)
  136.     festlegen/einstellen können. 
  137.   - Klicken Sie "Sichern" um den Pfad+Datei im CPX-Modul zu sichern.
  138.   - Klicken Sie "OK" und Sie kommen wieder ins Hauptmenü
  139.   - ... und jetzt kann's los gehen :-)
  140.  
  141.  
  142.   START / BEDIENUNG
  143.   ----------------------------------------------------------------------------
  144.  
  145.   Nach öffenen des modularen Kontrollfeldes von ATARI, kommen Sie mit
  146.   Doppelklick auf den Eintrag "Telefonbuch" in das Hauptanzeigefeld von 
  147.   TELEINX.CPX.
  148.   
  149.   Wie Sie erkennen können, benutzt TELEINX.CPX eine Menüleiste, welche wie 
  150.   bei vielen anderen GEM-Programmen zu bedienen ist.
  151.   
  152.   Unterhalb der Menüleiste, können Sie die Namen und Telefonnummern der
  153.   aktuellen Telefonnummerndatei betrachten (Hauptanzeigefeld). 
  154.  
  155.   Beginnen wir mit der Menüleiste:
  156.  
  157.   Info
  158.   ----
  159.   Nach betätigen dieses Menüeintrages, kommen Sie in einen Dialog, in welchem
  160.   sich die Copyrighthinweise, sowie die aktuellen Versionsdaten zum CPX-Modul
  161.   befinden. 
  162.  
  163.   Quit ( OK )
  164.   -----------
  165.   Über diesen Menüeintrag kann das CPX-Modul verlassen werden. Dieser Button
  166.   hat den selben Effekt wie der Button OK, unterhalb des Hauptanzeigefeldes.
  167.   
  168.   
  169.   Datenbank Setup
  170.   ---------------
  171.  
  172.   o Max. Einträge/Buchstabe
  173.  
  174.     Hier haben Sie die Möglichkeit einzustellen, wieviel Einträge pro Buch-
  175.     stabe (A-Z,?,!) das CPX-Modul aus der geladen Adressendatei im Haupt- 
  176.     anzeigefeld anzeigen soll.
  177.     Befinden sich im Hauptanzeigefeld unter einem Index-Buchstaben mehr Daten-
  178.     sätze, als unter "Max. Einträge/Buchstabe" eingestellten Wert, wird der 
  179.     letzte Datensatz mit "**" markiert, welches einem signalisiert, das unter 
  180.     diesem Buchstaben noch mehr Datensatze vorhanden sind. 
  181.     Man kann nun den Wert von Max. Einträge/Buchstabe erhöhen.
  182.  
  183.     Kann das CPX-Modul nicht genügend Speicher für die geforderte Anzahl von
  184.     Einträgen bekommen (wenn z.B. ein anderes Programm einfach allen Speicher
  185.     für sich reserviert hat) so erscheint eine Alert-Box. Eine Anzeige der
  186.     Datensätze ist dann nicht möglich.
  187.   
  188.   o Schrift
  189.   
  190.     Hier können Sie den Schrifttyp (Groß, klein) wählen, mit welchem im
  191.     Hauptanzeigefeld die Datensätze angezeigt werden sollen.
  192.   
  193.   o Telefonverzeichnis Datei
  194.  
  195.     Durch Klick auf die Pfadzeile bekommen Sie die Fileselectorbox, mit 
  196.     welcher Sie den Pfad sowie die aktuelle Telefonnummerndatei auswählen,
  197.     einstellen können.
  198.     
  199.   o Sichern
  200.     
  201.     Durch Anwahl von "Sichern" werden die vorgenommen Einstellungen dauerhaft
  202.     in TELEINX.CPX gespeichert.
  203.     
  204.   o OK        -  bestätigen der letzten Änderungen/Eingaben
  205.   
  206.   o Abbruch   -  verwerfen der letzten Änderungen/Eingaben
  207.     
  208.    
  209.   Modem Setup
  210.   -----------
  211.   
  212.   o Modem
  213.   
  214.     Hier werden die an das Modem zu sendende Steuercodes eingestellt, welche
  215.     das Modem dazu veranlassen die angezeigte/ausgewählte Telefonnummer zu 
  216.     wählen.
  217.     
  218.     Parameter:
  219.       # = Telefonnummer
  220.       | = CR (Return)
  221.       ~ = Pause von 0.5 sek. beim senden der Steuerzeichen
  222.   
  223.           Natürlich können auch Modemeigene Parameter verwendet werden,
  224.           sowie CTRL-M als CR Ersatz geht auch !
  225.       
  226.     Init - Anwahlparameter zum Modem
  227.     
  228.            hier hat sich folgender Anwahlstring als günstig erwiesen:
  229.            
  230.            ATZ|~~~ATL2DT#|
  231.            
  232.            ATZ  = Modem Reset
  233.            ATL2 = Modem Lautsprecher auf Lautstärke 2
  234.              DT = Dail Tone (bei Bedarf auf Pulswahl umstellen = DP)
  235.           
  236.     Exit - Auflegeparameter zum Modem
  237.  
  238.            hier hat sich folgender Auflegstring als günstig erwiesen
  239.  
  240.            ATH|~
  241.  
  242.            ATH = Off Hook (= Modem legt auf)
  243.  
  244.            falls das Modem es verkraftet geht auch "ATZ|~"
  245.           
  246.     Repeat - Wahlwiederholung zum Modem
  247.     
  248.            Falls das Telefon des gewünschten Partners besetzt ist, erkennt
  249.            das Modem ein BUSY (= Besetztzeichen). TELEINX bietet nun die 
  250.            Möglichkeit an das Modem einen Repeatstring zu senden, welches 
  251.            auch die meisten Modems verstehen (Hayes-Standart) und zu 
  252.            einer Wahlwiederholung führt:
  253.           
  254.            A>~ = Letzter Befehl ("ATDT#|") einmal wiederholen, die zuletzt
  255.                  gewählt Nummer bis zu neun Mal erneut anwählen (die 
  256.                  Anzahl der Versuche ist vom Modem/Staat abhängig)
  257.           
  258.            Alternativen:
  259.           
  260.            A/~ = Letzter Befehl einmal wiederholen
  261.           
  262.            ATDL~ = Dial Last = einmalige Wahlwiederholung
  263.           
  264.            ATDT#~ =  siehe "ATDL"
  265.           
  266.           
  267.   o Schnittstelle
  268.     
  269.     Diese PopUpMenü dient zur Einstellung/Veränderung des Ausgabekanals/
  270.     Schnittstelle an welche TELEINX.CPX die Modemparameter/Steuercodes 
  271.     senden soll.
  272.  
  273.     Es gibt 10 verschiedene Schnittstellenmöglichkeiten:
  274.  
  275.     - PRN       (Paralelle, meist Drucker !)
  276.     - AUX       (Serielle, aktueller Ausgabekannal, welcher über das
  277.                  SERIELL.CPX-Modul eingeschaltet/deffiniert ist.)
  278.     - CON       (Bildschirm (mit VT52), direkt !)
  279.     - MIDI      (MIDI)
  280.     - IKBD      (Input Keyboard)
  281.     - RAWCON    (Bildschirm (ohne VT52), direkt)
  282.     - Modem 1   (only Atari STE/TT)
  283.     - Modem 2   (only Atari STE/TT)
  284.     - Seriell 1 (only Atari STE/TT)
  285.     - Seriell 2 (only Atari STE/TT)
  286.  
  287.   o Sichern
  288.     
  289.     Durch Anwahl von "Sichern" werden die vorgenommen Einstellungen dauerhaft
  290.     in TELEINX.CPX gespeichert.
  291.   
  292.   o OK        -  bestätigen der letzten Änderungen/Eingaben
  293.   
  294.   o Abbruch   -  verwerfen der letzten Änderungen/Eingaben
  295.  
  296.  
  297.   Index
  298.   -----
  299.   Durch Anwahl dieses Menüpunktes öffnet sich ein PopUpMenü (Buchstaben A-Z,
  300.   ? und ! ). Um Adressen abzurufen, klicken Sie einfach den den Anfangs-
  301.   buchstaben des gesuchten Namens. Die gewählten Adressen mit dem ent-
  302.   sprechenden Anfangsbuchstaben werden darauf sofort im Hauptanzeigefeld 
  303.   angezeigt. Sind keine passenden Einträge vorhanden bleibt das 
  304.   Hauptanzeigefeld leer.
  305.   
  306.   Aufbau:
  307.   
  308.   A-Z: Einträge mit Anfangsbuchstaben von A-Z
  309.     ?: Einträge mit anderen Anfangsbuchstaben (Sonderzeichen, Umlaute)
  310.     !: Einträge mit dem Anfangsbuchstaben "!"
  311.        (Dieser Eintrag ist gedacht für Notrufnummern wie die Feuerwehr, 
  312.         Polizei, Notruf, Ärzte, uva.)
  313.   
  314.  
  315.   Hauptanzeigefeld
  316.   ----------------
  317.   Sofort nach dem öffnen des CPX-Modules können Sie das Hauptanzeigefeld in
  318.   Form einer Listenausgabe je Anfangsbuchstabe erkennen.
  319.   
  320.   Hier können Sie die Adressen im folgendem Format betrachten:
  321.   
  322.     1. Zeile: Namen des 1. Adresseneintrages   (linksbündig)
  323.     2. Zeile:      dazugehörige Telefonnumer   (rechtsbündig)
  324.     3. Zeile: Namen des 2. Adresseneintrages   (linksbündig)
  325.     4. Zeile:      dazugehörige Telefonnumer   (rechtsbündig)
  326.      .... usw.
  327.   
  328.   Sind mehr als 4/8 (Schrift: Groß/klein) Einträge vorhanden, so können Sie
  329.   mit dem Slider auf der rechten Seite durch die Einträge blättern.
  330.   
  331.   Durch selektieren eines Eintrages (Name oder Telefonnummer) in der 
  332.   Listenanzeige, öffnet sich eine PopUpMenü, mit welchem Sie folgende
  333.   Auswahlmöglichkeiten besitzen:
  334.   
  335.     Anzeigen -> Maskenanzeige    (detailierte Anzeige des Datensatzes)
  336.     Wählen   -> Anwählen des selektierten Gesprächpartners     (Modem)
  337.   
  338.   Befinden Sie sich in der Maskenanzeige und selektieren Sie hier den 
  339.   Datensatz, öffnet sich folgendes PopUpMenü:
  340.   
  341.     Liste    -> zurück zur Listenanzeige
  342.     Wählen   -> Anwählen des selektierten Gesprächspartners    (Modem)
  343.   
  344.   
  345.   Wählvorgang
  346.   -----------
  347.   Haben Sie eine Datensatz selektiert und im PopUpMenü "Wählen" ausgewählt
  348.   kommen Sie in den Wähldialog.
  349.   
  350.   Mittig können Sie nochmal den gewählten Datensatz mit Name und Telefon-
  351.   nummer des gewünschten Geprächspartners erkennen.
  352.   
  353.   TELEINX.CPX beginnt sofort mit dem Wählvorgang (Senden von Modem INIT)
  354.   
  355.   o Auflegen  (Senden von Modem EXIT)
  356.   
  357.     Kommt eine Verbindung zustande, nehmen Sie den Telefonhörer ab und
  358.     betätigen Sie 'Auflegen' = RETURN
  359.   
  360.   o Repeat    (Senden von Modem REPEAT)
  361.   
  362.     Ist die Telefonnummer des gewünschten Gesprächspartners belegt (BUSY),
  363.     können Sie durch betätigen von REPEAT eine Wahlwiederholung auslösen.
  364.     Kommt nach mehrmaliger Anwahl eine Verbindung zustande, nehmen Sie den
  365.     Telefonhörer ab und betätigen Sie 'Auflegen' = RETURN
  366.     
  367.   o Abbruch   -   verlassen des Wählvorganges ohne weiter Aktivitäten
  368.   
  369.  
  370.   DAS FORMAT DER TELEFONNUMMERN DATEI
  371.   ----------------------------------------------------------------------------
  372.  
  373.   Die Telefonnummern Datei ist denkbar einfach aufgebaut, ein erstellen per
  374.   Editor oder als Export aus einem Datenbank-Programm sollte keine Probleme
  375.   bereiten.
  376.  
  377.   Datensatzaufbau:
  378.   
  379.       1. Datenfeld:  Namen (Name, Vorname)
  380.       2. Datenfeld:  Telefonnummer
  381.     3-8. Datenfeld:  Frei deffinierbar
  382.     
  383.   Trenner:
  384.   
  385.     Datenfelder = "|"
  386.     Datensätze  = CR LF (Return + LineFeed)
  387.     
  388.   Grenzen:
  389.   
  390.     o  Datenfeld max. 28 Zeichen (Großer Zeichensatz)
  391.                  max. 36 Zeichen (Kleiner Zeichensatz)
  392.        sind mehr angegeben werde diese ignoriert/nicht angezeigt
  393.  
  394.     o  pro Datensatz max. 8 Datenfelder
  395.        sind mehr angegeben werden dies ignoriert/nicht angezeigt
  396.  
  397.  
  398.   Zu beachten ist, beim Export von Adressen aus Datenbanken (Phönix, Datamat,
  399.   Adimens, Twist, uva.), das TELEINX.CPX beim einlesen der Daten alle Zeichen
  400.   übernimmt, also auch störende Leerzeichen. Diese müssen Sie entweder selbst
  401.   entfernen oder entfernen lassen. Dies ist deswegen so, damit nötige
  402.   Formatierungen von Einträgen möglich sind. 
  403.   
  404.   Beispiel:
  405.   
  406.   Mandel, Andreas|0781-38807|Postfach 26|7601 Ortenberg|<77799> Ortenberg
  407.   Güth, Alexander|1234-56789|Himmelsleiter 7411|2001 Odysee|Fax 334499
  408.   
  409.  
  410.   BEKANNTE BESCHRÄNKUNGEN / BUGs
  411.   ----------------------------------------------------------------------------
  412.  
  413.   o Keine Fehlerkorrekturen
  414.   
  415.     Das Programm schickt keine Fehlermeldungen. Falls also irgendwas nicht
  416.     so funktioniert oder läuft wie es sollte, überprüfen Sie zuerst die
  417.     eingestellten Parameter (Pfad der Telefondatei) sowie den Datenaufbau
  418.     der Telefondatei.
  419.     
  420.   o TELEINX.CPX funktioniert nur dann, wenn das Telefon entweder hinter oder
  421.     parallel zum Modem hängt. 
  422.  
  423.  
  424.   TIPs und KNIFFE
  425.   ----------------------------------------------------------------------------
  426.  
  427.   o Wunderbar läßt ich auch TELEINX.CPX als Hintergrunddialer für Mailboxen
  428.     verwenden. Einfach z.B. MAUS.DAT laden (MausNet-Mailboxen) und die ge-
  429.     wünschte Maus anwählen lassen. Ist diese besetzt, einfach REDAIL starten.
  430.     Im Vordergrund kann man bequem in seiner Textverarbeitung oder sonst.
  431.     Application weiterarbeiten.
  432.     Kommt eine Verbindung zustande (man hört das :-) ), ist angesagt, ent-
  433.     weder die Application schnell zu verlassen (Sichern der Daten nicht ver-
  434.     gessen !!!) und in das Terminalprogramm (CoNnect, Rufus) zu gehen, oder 
  435.     auch ein Terminalprogramm als Accessory (Harlekin) aufzurufen.
  436.     
  437.     Unter MultiTOS ist das natürlich viel schöner, da muß man nur die 
  438.     laufende Application wechseln :-).
  439.  
  440.  
  441.   HISTORY
  442.   ----------------------------------------------------------------------------
  443.  
  444. ?????.92  V2.00   pro Datensatz sind jetzt 8 Felder möglich.
  445. 10.02.93  V2.01   Bug, der uU die RSC-Texte von Teleinx ,,kürzte'' gefixt.
  446. 20.04.93  V2.05   Kleine Bugfixes, Umgestellt auf "Menü-CPX", Modem-Dialer.
  447.